home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / ifl / TIFFWriteEncodedStrip.z / TIFFWriteEncodedStrip
Text File  |  1998-10-20  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. TTTTIIIIFFFFFFFFWWWWrrrriiiitttteeeeEEEEnnnnccccooooddddeeeeddddSSSSttttrrrriiiipppp((((3333TTTT))))            IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      TIFFWritedEncodedStrip - compress and write a strip of data to an open
  10.      TIFF file
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttiiiiffffffffiiiioooo....hhhh>>>>
  14.      ttttssssiiiizzzzeeee____tttt TTTTIIIIFFFFFFFFWWWWrrrriiiitttteeeeEEEEnnnnccccooooddddeeeeddddSSSSttttrrrriiiipppp((((TTTTIIIIFFFFFFFF**** ttttiiiiffff,,,, ttttssssttttrrrriiiipppp____tttt ssssttttrrrriiiipppp,,,, ttttddddaaaattttaaaa____tttt bbbbuuuuffff,,,,
  15.      ttttssssiiiizzzzeeee____tttt ssssiiiizzzzeeee))))
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      Compress _s_i_z_e bytes of raw data from _b_u_f and write the result to the
  19.      specified strip; replacing any previously written data.  Note that the
  20.      value of _s_t_r_i_p is a ``raw strip number.''  That is, the caller must take
  21.      into account whether or not the data are organized in separate places
  22.      (_P_l_a_n_a_r_C_o_n_f_i_g_u_r_a_t_i_o_n=2).
  23.  
  24. NNNNOOOOTTTTEEEESSSS
  25.      The library writes encoded data using the native machine byte order.
  26.      Correctly implemented TIFF readers are expected to do any necessary
  27.      byte-swapping to correctly process image data with BitsPerSample greater
  28.      than 8.
  29.  
  30.      The strip number must be valid according to the current settings of the
  31.      _I_m_a_g_e_L_e_n_g_t_h and _R_o_w_s_P_e_r_S_t_r_i_p tags.  An image may be dynamically grown by
  32.      increasing the value of _I_m_a_g_e_L_e_n_g_t_h prior to each call to
  33.      _T_I_F_F_W_r_i_t_e_E_n_c_o_d_e_d_S_t_r_i_p.
  34.  
  35. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  36.      -1 is returned if an error was encountered.  Otherwise, the value of _s_i_z_e
  37.      is returned.
  38.  
  39. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  40.      All error messages are directed to the _T_I_F_F_E_r_r_o_r(3T) routine.
  41.  
  42.      %%%%ssss:::: FFFFiiiilllleeee nnnnooootttt ooooppppeeeennnn ffffoooorrrr wwwwrrrriiiittttiiiinnnngggg.  The file was opened for reading, not
  43.      writing.
  44.  
  45.      CCCCaaaannnn nnnnooootttt wwwwrrrriiiitttteeee ssssccccaaaannnnlllliiiinnnneeeessss ttttoooo aaaa ttttiiiilllleeeedddd iiiimmmmaaaaggggeeee.  The image is assumed to be
  46.      organized in tiles because the _T_i_l_e_W_i_d_t_h and _T_i_l_e_L_e_n_g_t_h tags have been
  47.      set with _T_I_F_F_S_e_t_F_i_e_l_d(3T).
  48.  
  49.      %%%%ssss:::: MMMMuuuusssstttt sssseeeetttt """"IIIImmmmaaaaggggeeeeWWWWiiiiddddtttthhhh"""" bbbbeeeeffffoooorrrreeee wwwwrrrriiiittttiiiinnnngggg ddddaaaattttaaaa.  The image's width has not
  50.      be set before the first write.  See _T_I_F_F_S_e_t_F_i_e_l_d(3T) for information on
  51.      how to do this.
  52.  
  53.      %%%%ssss:::: MMMMuuuusssstttt sssseeeetttt """"PPPPllllaaaannnnaaaarrrrCCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn"""" bbbbeeeeffffoooorrrreeee wwwwrrrriiiittttiiiinnnngggg ddddaaaattttaaaa.  The organization
  54.      of data has not be defined before the first write.  See _T_I_F_F_S_e_t_F_i_e_l_d(3T)
  55.      for information on how to do this.
  56.  
  57.      %%%%ssss:::: NNNNoooo ssssppppaaaacccceeee ffffoooorrrr ssssttttrrrriiiipppp aaaarrrrrrrraaaayyyyssss"""".  There was not enough space for the
  58.      arrays that hold strip offsets and byte counts.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. TTTTIIIIFFFFFFFFWWWWrrrriiiitttteeeeEEEEnnnnccccooooddddeeeeddddSSSSttttrrrriiiipppp((((3333TTTT))))            IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      _l_i_b_t_i_f_f(3T), _T_I_F_F_O_p_e_n(3T), _T_I_F_F_W_r_i_t_e_S_c_a_n_l_i_n_e(3T), _T_I_F_F_W_r_i_t_e_R_a_w_S_t_r_i_p(3T)
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.